home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / mdl10.zoo / readme < prev    next >
Text File  |  1993-06-06  |  3KB  |  90 lines

  1. mdl v1.0 (93/06/06)
  2. -------------------
  3.  
  4. This is mdl, a TOS program to animate DL files (*.dl) on a monochrome Atari
  5. ST. It is hard coded for 640x400 displays and uses Setscreen to do the
  6. flicker mode thing (similar to my MGIF code). So, it won't run on color and
  7. won't run on larger displays. It was a 1 day hack. If you don't like how it
  8. works, I have thoughtfully provided source code for you to "make it right".
  9.  
  10. DL files are not that predominant (I have only a very few). There is little
  11. documentation that I have found. mdl was based on xdl, a unix program for
  12. running under X windows. I basically used xdl to get the file format.
  13.  
  14. Included in this distribution are the following files:
  15.  
  16. Name        Description
  17. -------------------------------------------------------------------------
  18. dl.5        compiled manpage for the DL file format (manpager format)
  19. dl.ma5        nroff manpage for the DL file format
  20. mdl.c        source code (known to work with GCC 1.4, MiNT libs PL 19)
  21. flicker.c    more source code
  22. makefile    makefile for mdl and manpages (check before running)
  23. mdl.l        compiled manpage for mdl (manpager format)
  24. mdl.man        nroff manpage for mdl
  25. mdl.ttp*    executable
  26. mkdl.c        source for a program to make a test .dl file (see src)
  27. mkdl.ttp*    its executable
  28. readme        this file
  29. test.dl        test DL file
  30. unix_xdl.zoo    the source for Xdl (unix X windows program)
  31.  
  32.  
  33. There are (at least) 2 versions of DL files. mdl reads version 1 and 2 files.
  34. It was, however, only tested on version 2 DL files and only those with
  35. medium format (four 160x100 images per "screen).
  36.  
  37. Here is the file format as far as I can tell:
  38.  
  39. DL version 1 files:
  40.  
  41. size
  42. bytes        desc
  43. ------------------------------------------------------------------------------
  44. 1        version number (1). image format (implicit) is 1 (medium)
  45. 20        title (XOR'ed with 0xff)
  46. 1        number of screens (nscr)
  47. 1        number of commands (ncmd)
  48. 1        ? something to do with colormap and border colors
  49. 768        colormap (3 bytes per color, 256 colors)
  50. 320*200*nscr    data for each screen
  51. ncmd        commands in an unknown format (see source code for details).
  52.         the last command can be negative (unknown reason) and is to
  53.         be ignored.
  54.  
  55.  
  56. DL version 2 files:
  57.  
  58. size
  59. bytes        desc
  60. ------------------------------------------------------------------------------
  61. 1        version number (2)
  62. 1        format (0=large320x200, 1=medium160x100)
  63. 20        title (XOR'ed with 0xff)
  64. 20        author (XOR'ed with 0xff)
  65. 1        number of screens (nscr)
  66. 1        number of commands (ncmd)
  67. 3        ? something to do with colormap and border colors
  68. 768        colormap (3 bytes per color, 256 colors)
  69. 320*200*nscr    data for each screen (if format==0, single image per screen,
  70.         if format==1, 4 images per screen)
  71. 2*ncmd        commands, little-endian (byte swapped 16-bit words). the last
  72.         command can be negative (unknown reason) and is to be ignored.
  73.  
  74. Commands appear to be just a list of frames to display in a loop. For example,
  75. given four frame images (0 through 3), the commands:
  76.  
  77.     0 1 2 3 2 3 2 3 2 1 2 1 2 1
  78.  
  79. can create an animation showing these frames in succession. You can thus have
  80. far fewer actual bitmap images that "frames" in the animation loop.
  81.  
  82. Report bugs and enhancements to me if you want (rosenkra@convex.com).
  83.  
  84.  
  85. Enjoy...
  86.  
  87. -Bill Rosenkranz
  88. rosenkra@convex.com
  89.  
  90.